From: Emmanuele Bassi <ebassi@gnome.org>
Date: Wed, 6 Jul 2022 12:04:22 +0000 (+0100)
Subject: docs: Clarify scope of gtk_widget_clear_template()
X-Git-Tag: archive/raspbian/4.8.3+ds-2+rpi1~3^2~81^2^2~77^2~11
X-Git-Url: https://dgit.raspbian.org/%22http://www.example.com/cgi/%22/%22http:/www.example.com/cgi/%22?a=commitdiff_plain;h=620d48ca0cd4726fd628e82d940e1510bfc080a7;p=gtk4.git

docs: Clarify scope of gtk_widget_clear_template()

The clear_template() method only clears the template children.
---

diff --git a/gtk/gtkwidget.c b/gtk/gtkwidget.c
index 432e10301b..8c943d15af 100644
--- a/gtk/gtkwidget.c
+++ b/gtk/gtkwidget.c
@@ -10974,10 +10974,13 @@ out:
  * @widget: the widget with a template
  * @widget_type: the type of the widget to finalize the template for
  *
- * Clears the template data for the given widget.
+ * Clears the template children for the given widget.
  *
  * This function is the opposite of [method@Gtk.Widget.init_template], and
- * it is used to clear all the template data from a widget instance.
+ * it is used to clear all the template children from a widget instance.
+ * If you bound a template child to a field in the instance structure, or
+ * in the instance private data structure, the field will be set to `NULL`
+ * after this function returns.
  *
  * You should call this function inside the `GObjectClass.dispose()`
  * implementation of any widget that called `gtk_widget_init_template()`.